If you are upgrading from an older version of Monkey Shines, please read the version history at the end of this document. There are many changes in version 1.2.
Introducing Bonzo
Bonzo is an adventuresome ape, and always seems to get into trouble. He's really done it this time, and wakes up after a heavy night on the jungle juice to find himself in a haunted house, with strange creatures all around. Can you get Bonzo back home to his family ?
Controlling Bonzo couldn't be simpler. Use the keyboard to move Bonzo left and right and to make Bonzo jump. The default keys are the arrow keys - use the left and right arrow keys to make Bonzo walk left and right, and the up arrow key to jump. You can customise these keys or use a joystick. See the section on 'joysticks' for some important information.
Bonzo is a pacifist, so he will have to rely on your skills to avoid his enemies (anything which moves and several things which don't!).
In order to get home, Bonzo has to pass through five different worlds. To complete a world, guide Bonzo to get all the red keys. Once you have these, an exit door will appear somewhere in the world. Hurry, because your bonus will be counting down... The blue keys will allow Bonzo to explore a bonus level. Get them all, find the door, and grab those extra points.
There is plenty of fruit to collect for even more points (get them all for a special bonus), and other objects which will help Bonzo in his quest.
The wing protects Bonzo from damage due to falling. Long falls cost Bonzo some of his energy, and when he loses all his energy, you lose a life.
The shield protects Bonzo from ALL enemies.
The lightning strike replenishes Bonzo's energy.
The x2, x3 and x4 increase the value of all fruit and keys collected.
These 'power-ups' only last for a short time, so make the most of them.
Bonzo's enemies
These are many and varied. Monkey Shines features over 100 animated enemies. If it moves, it's up to no good. There are some things which don't move but also kill Bonzo. These include bombs, light bulbs and pools of molten lava. There are a few others, which we are sure you will find!
Bonzo has a special dislike for bees, and the bees don't like Bonzo much either. Bee stings are not immediately fatal, but they will drain Bonzo of energy. Try to steer clear.
The legal stuff
Well, we might as well get this out of the way now.
Monkey Shines is shareware. It is not a free product. You may test Monkey Shines free of charge for up to 30 days. After that time you must either pay for Monkey Shines or delete it from your hard disk. To pay for Monkey Shines, print out and complete the document 'Monkey Shines Order Form' which should be in the Monkey Shines folder (if you don't have this document, contact us at the address below) and send it to Fantasoft with your payment (the address is given below). The registration fee is $20. You can pay by cash, check, money order and major credit cards (Visa, Mastercard, American Express and Discover). When you send us your payment we will send you a registration number which will personalise your copy of Monkey Shines and allow you to play all the levels (the unregistered game will only allow you to play the first world - about 40 levels) plus any you design yourselves.
We can accept checks in most foreign currencies. Just send a check for the equivalent of $20 U.S. See the document 'Monkey Shines Order Form' for a list of common exchange rates.
We encourage you to distribute Monkey Shines far and wide. However, you may ONLY distribute the unregistered version, and you must include ALL the files. You must NOT charge any money for distributing Monkey Shines. You may include Monkey Shines on your ftp site/web page as long as you do not charge per download, and you have all the original files in an unaltered state. You may not include Monkey Shines on a CD-ROM compilation* without the permission of Fantasoft LLC. Contact us at the address below for details. You may not distribute modified versions of the Monkey Shines application under any circumstances.
Since we are giving you access to the Monkey Shines Level Editor, you may distribute modified world files. However, these must be clearly labelled as such. If you wish to bundle 3rd party levels with the 'official' Monkey Shines distribution (e.g. on a magazine cover CD) please put the levels in a folder called "3rd Party Levels" inside the Monkey Shines folder, and also include the documentation for the level.
* CD-ROMS included free of charge with magazines are exempt from this.
Getting Started
Monkey Shines consists of 7 files. These are the 'Monkey Shines' application,the 'Monkey Shines Data' file and the world files 'Bonzo World 1', 'Bonzo World 2', 'Bonzo World 3', 'Bonzo World 4' and 'Bonzo World 5'. Ideally these files should all be in the same folder, but if the world files are on a CD ROM, they will still be found. There is also a 'Monkey Shines Level Editor' which is optional, and will allow you to create your own levels for Bonzo to explore.
Monkey Shines will run happily from a CD-ROM or other external disk. However, we really recommend that you copy the Monkey Shines application and 'Monkey Shines Data' to your hard disk before playing. It will load much faster. You will probably want to put all the world files in the same folder on your hard disk, but if you haven't got much disk space, you can install only the worlds you wish to play, or if you have Monkey Shines on a CD ROM, insert the CD and Monkey Shines will find the files. Since the CD ROM will not be accessed during the game, there should not be a performance hit. Basically, put things where you want them and leave Monkey Shines to worry about it.
Bonzo World 1 = Spooked
Bonzo World 2 = Spaced Out
Bonzo World 3 = About the House
Bonzo World 4 = In the Drink
Bonzo World 5 = In the Swing
Now just double-click on the 'Monkey Shines' application, and you're on your way.
When you have configured Monkey Shines to your satisfaction (music and sound volume, key settings) click on 'New Game' to play. You will then have to choose the world you want to start on. Unregistered users can only play 'Spooked'. When you register (pay!), we will send you a code which will personalise your copy of Monkey Shines and allow you to play all the levels, as well as any levels you design yourself. Don't edit 'Bonzo World 1' unless you have registered - the game will not accept modified versions of this file.
Customising Keys
Monkey Shines now (as of version 1.2) uses Apple's Input Sprocket to customise input devices. This allows support for a wide range of joysticks with minimal effort. Using the customisation dialog you can save as many settings as you like. You can even play Monkey Shines using the mouse, although we don't recommend it.
Special Keys
Due to constraints with Input Sprocket, the pause key is now "Escape" and cannot be reconfigured. The default settings have command-q to quit directly back to the finder, command-a will abort the current game, and 'a' will abort one life (useful if you get stuck on a level with no way to die). These can all be configured to suit your preferences.
You can also quit (command-q) from the world selection screen, or go back to the main screen by pressing 'escape'.
Pausing the Game
During the game, you can pause using the 'Escape' key. This will allow you access to the menu bar and allow you access to the Finder and other applications. Select 'Resume' from the 'Game' menu to continue. You may also change the sound and music volume when paused.
Multiple Monitors
If you are lucky enough to have more than one monitor capable of running Monkey Shines, you will be asked to choose which screen you wish to play on. This configuration is automatic through Apple's DrawSprocket.
System Requirements
Monkey Shines requires a colour MacOS compatible computer (Apple Macintosh or clone) with a 68020 or higher processor (Monkey Shines is also PowerPC-native) and 5000K free RAM. It requires the provided Apple Game Sprockets extensions to be copied to your extensions folder.
Monkey Shines needs a screen capable of displaying 640 x 480 pixels or more in 256 colours.
Monkey Shines requires that you be running at least System 7.1, and strongly recommends that you have Sound Manager 3.1 or higher installed (Sound Manager 3.2.1 is the current version). If you have only 8MB total RAM, you may need to disable some system extensions in order to make 5000K available for Monkey Shines. To do this, use the 'Extensions Manager' control panel to disable unnecessary extensions. Increasing the memory allocation to Monkey Shines above 5000K makes very little difference, except on slower macs.
Performance Issues
Monkey Shines uses many techniques to get maximum performance from slower Macs. However, Macs with 68020 or 68030 processors (e.g. the LC, LCII, LCIII and their Performa equivalents) may struggle a little. By default the music is turned off on these machines. You may turn it on if you wish (use the menu bar, not the volume control slider), but we feel that the performance will be unacceptable.
Turning the music off using the menu bar is not the same as setting the volume to zero using the volume control. In order to see the performance gains, you MUST disable the music from the menu. Setting the sound volume to zero will cause sounds not to be played, and you will see a slight improvement in performance on slower machines.
On the slowest Macs, loading a world file or moving between screens in the interface can take quite a long time (often more than a minute to load the game data on an LC). Don't assume Monkey Shines has crashed! Just be a little patient. In order to make the actual game as fast as possible, we had to do a little more work while the level is loading - there are a lot of graphics to load, so give it a bit more time. It's worth it! The performance of the actual game will still be pretty good.
QuickDraw or not QuickDraw
Apple's graphics code for the MacOS is called 'QuickDraw'. In order to get the best performance, Monkey Shines doesn't normally use QuickDraw. Since this may be a problem with 3rd party video cards or future versions of the MacOS, we provide an option to use QuickDraw (although in over a year we have had no reported conflicts with our custom graphics code). Simply select the 'Use QuickDraw' menu option. This menu item will have a tick at the side of it if QuickDraw is enabled. All PowerPC Macs and some of the faster 68040 Macs will be fast enough to use QuickDraw. Slower Macs such as the LCII need all the help they can get, so you shouldn't use QuickDraw on these machines. The fast Monkey Shines graphics code obeys all the rules, so it is unlikely that you will have problems.
The Menu Bar
Yup, we hide it from you. It's not like we don't trust you. In fact, if you click the mouse where the menu bar should be, you'll find it was there all along. Use the menu to disable the music, or to turn the QuickDraw option on or off. It's your Mac, and we want you to decide.
Joysticks
As of version 1.2, we now use Apple's InputSprocket to configure joysticks. This offers support for more devices than JoyManager, and deals with input configuration itself. One less piece of code to debug !
Troubleshooting
1. Monkey Shines crashes
- it shouldn't ! Monkey Shines has been tested extensively on a whole range of Macs.
Here is a list of things to try if you run into problems.
1. Look in your extensions folder (in your system folder) for a file called 'SoundLib'. If you find it, remove it. Honestly, you don't need it, and it is known to conflict with the music code.
2. Delete the preferences file (it is called 'Monkey Shines 1.2 Prefs' and you will find it in the Preferences folder inside your system folder).
3. Are you running in 24 bit memory mode ? Open the 'Memory' control panel and make sure it is set to '32 bit'. If you have a PowerPC mac, make sure the modern memory manager is turned on (newer systems may not have a choice - if this is the case, you should be fine).
4. Are you using virtual memory or RAM Doubler ? Monkey Shines is compatible with virtual memory, but may suffer from performance problems, especially on the slower Macs or those with not enough physical RAM. Virtual memory is not a substitute for real RAM.
5. Do you have a system extension which is causing problems ? Try using Apple's 'Extension Manager' to turn off extensions which are not written by Apple.
If you have tried everything and still can't get Monkey Shines to run properly, contact Fantasoft and we will try to help you. The address is at the bottom of this document. Please include as much detail as possible (e.g. type of mac, amount of RAM, version of system software, system extensions, etc.). Bug reports like 'it crashes, I hate you' aren't much help (we have had some like that, honest!).
Using Levels Designed by Other People
Monkey Shines includes a level editor so that you can design your own levels or modify ours. You will not be able to use modified levels until you have registered (paid for) Monkey Shines. To play a 3rd party world, simply click on 'other' in the world selection screen. This will then prompt you to find the world file using a standard 'open file' dialog. Third-party worlds can not be played in a specific order, since the game won't know which world to go to next. If you want to make your world file come second out of five, simply name it 'Bonzo World 2'.
The editor may not always behave as you would expect for a good Mac program. If you have trouble, let us know what you think should be changed, and we will look into it. If you do manage to find a bug, please tell us so we can fix it. You are strongly advised to back up your levels regularly in case of crashes. Philip Roy has written a tutorial for the level editor. It's so good that we made it the official documentation, and it is now included with the level editor for download from <http://www.fantasoft.com>. If you got Monkey Shines on a cover CD, it should also have the level editor and tutorial.
Getting the latest version of Monkey Shines
You can always get the latest version of Monkey Shines from Fantasoft. If you have world-wide-web access, point your browser at <http://www.fantasoft.com/> to download it. Your favourite Mac magazine should have the most recent version on its cover CD. If not, tell us (and them!) so we can arrange it.
If all else fails, for a nominal charge we will mail you the latest version on disk or CD. See the registration form for details.
A Final Note
We like to think that Monkey Shines is a high quality shareware product. This game has taken a lot of time to produce, and only by supporting shareware can we ensure the production of more games of this quality. Many companies are now distributing high quality software under the shareware scheme. It's good for all of us, because you get the chance to try the software before you pay, and we can keep our overheads down, and give you the software at a reasonable cost. If you want to see more high quality software for the Macintosh, please support shareware.
And if you don't like Monkey Shines, please feel free to tell us why!
A further note. Monkey Shines 2 - Gorilla Warfare is coming soon to a Macintosh near you. Featuring 60 frames per second scrolling action, and an all new hero, this game is sure to please all Monkey Shines fans.
Acknowledgements
We would like to thank many people who helped out during the creation of this game. First of all, Antione Rosset for the 'Player Pro' libraries which play the music. Thanks also to Ingemar Ragnemalm for the SAT libraries - Monkey Shines doesn't use SAT, but it got me started. I would also like to thank Alex Metcalf for various tips and advice, Brent Schorsch at Apple for help with InputSprocket, Philip Roy for recent testing and sheer enthusiasm and David Lau for the delivery service!!!
Credit is also due to Metrowerks for producing the best development tools on the market.
Finally, thanks to the team of beta testers, Rose 'BamBam' Cooper, Steffan Davies, Vern Jensen, Eric Kornblum, Rich O'Brien, Alex Moratorio, Kjetil, Kevin Hendrickson, AstroNine, Jeff Robison, Eric Wohlstadter, Teddy Schatz, Jason R. Etheridge, John Forbes and Bill Greentree.
Version History
1.0.0. Initial Release
1.0.2. Better error checking in the music code to help us try to locate the problems some people were having.
1.0.3. Better handling of the 'world file not found' dialog. The application looks for the selected world file in the same folder, but if it isn't there, all mounted volumes (including CDs) are searched. High scores are now stored in the preferences file. This means that Monkey Shines doesn't have to create a file in its own folder, so it will run better from locked volumes (e.g. CDs). If you have a high scores file from an older version, the scores will be copied into the preferences file and the old high scores file deleted. World 2 had a bug which is now fixed.
1.1 Rewrote the entire graphics engine! The limitation whereby two sprites could not overlap is now gone (see older versions of the level editor manual for details). Added a QuickDraw compatibility option. Changed the paused screen to read 'Paused' instead of 'Time Out', since this was confusing some people. Fixed a bug with the error message warning. Updated the music libraries. Hopefully this will fix the problems people have had with the stability of the music (if not, we left the appropriate sections of the troubleshooting section in place.
1.1.1 Fixed a bug in the 'death by bee sting'. Quite a spectacular one actually!
1.1.2 Updated music code to version 4.5.8. Some people are still having trouble. If you are one of those people, look in your extensions folder (in your system folder) for a file called 'SoundLib'. If you find it, remove it. Honestly, you don't need it.
1.2. There is now a Monkey Shines Data file containing the artwork and audio. This will hopefully remove the need for patch applications as and when updates are released. This file MUST be in the same folder as the application. Fixed several bugs with the file searching on MacOS Extended Format disks. Added resolution switching using DrawSprocket and support for user input configuration using InputSprocket. This will allow you to use most joysticks etc. without configuring them using the control panel. Updated music code yet again. IMPORTANT - Monkey Shines once again requires a screen capable of displaying 256 colours. If there is enough demand I will reintroduce support for lower screen depths.
1.2.1 This version works on both PowerPC and 68K Macs (basically, all Macs with a colour screen big enough for the game). Fixed a couple of minor bugs with our use of Apple's game sprockets.
How to contact us
By mail:
Fantasoft, LLC
P.O. Box 14261
Madison
WI 53714-0261
U.S.A.
By phone/fax: (608) 222 8468
By email: fantasoft1@aol.com
Visit our world wide web pages: <http://www.fantasoft.com/>
